Filter hook 'get_{$adjacent}_post_join'

Hook Information

Hook Parameters

Usage Examples

<?php
// Hook into get_{$adjacent}_post_join
add_filter('get_{$adjacent}_post_join', 'my_custom_filter', 10, 5);

function my_custom_filter($join, $in_same_term, $excluded_terms, $taxonomy, $post) {
    // Your custom filtering logic here
    return $join;
}

Source Code Context

<?php
1956  	 * @param bool         $in_same_term   Whether post should be in the same taxonomy term.
1957  	 * @param int[]|string $excluded_terms Array of excluded term IDs. Empty string if none were provided.
1958  	 * @param string       $taxonomy       Taxonomy. Used to identify the term used when `$in_same_term` is true.
1959  	 * @param WP_Post      $post           WP_Post object.
1960  	 */
1961  	$join = apply_filters( "get_{$adjacent}_post_join", $join, $in_same_term, $excluded_terms, $taxonomy, $post );
1962  
1963  	/**
1964  	 * Filters the WHERE clause in the SQL for an adjacent post query.
1965  	 *
1966  	 * The dynamic portion of the hook name, `$adjacent`, refers to the type

PHP Documentation

<?php
/**
	 * Filters the JOIN clause in the SQL for an adjacent post query.
	 *
	 * The dynamic portion of the hook name, `$adjacent`, refers to the type
	 * of adjacency, 'next' or 'previous'.
	 *
	 * Possible hook names include:
	 *
	 *  - `get_next_post_join`
	 *  - `get_previous_post_join`
	 *
	 * @since 2.5.0
	 * @since 4.4.0 Added the `$taxonomy` and `$post` parameters.
	 *
	 * @param string       $join           The JOIN clause in the SQL.
	 * @param bool         $in_same_term   Whether post should be in the same taxonomy term.
	 * @param int[]|string $excluded_terms Array of excluded term IDs. Empty string if none were provided.
	 * @param string       $taxonomy       Taxonomy. Used to identify the term used when `$in_same_term` is true.
	 * @param WP_Post      $post           WP_Post object.
	 */